package com.yupi.yupicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yupi.yupicturebackend.api.aliyunai.model.CreateOutPaintingTaskRequest;
import com.yupi.yupicturebackend.api.aliyunai.model.CreateOutPaintingTaskResponse;
import com.yupi.yupicturebackend.model.dto.picture.*;
import com.yupi.yupicturebackend.model.entity.Picture;
import com.yupi.yupicturebackend.model.entity.User;
import com.yupi.yupicturebackend.model.vo.PictureVO;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
* @author tangwy
* @description 针对表【picture(图片)】的数据库操作Service
* @createDate 2025-05-08 09:46:18
*/
public interface PictureService extends IService<Picture> {

    /**
     * 上传图片
     * @param inputSource
     * @param pictureUploadRequest
     * @param loginUser
     * @return
     */
    PictureVO uploadPicture(Object inputSource,
                            PictureUploadRequest pictureUploadRequest,
                            User loginUser);

    /**
     * 将查询请求转换为 QueryWrapper 对象
     * @param pictureQueryRequest
     * @return
     */
    QueryWrapper<Picture> getQueryWrapper(PictureQueryRequest pictureQueryRequest);

    /**
     * 获取图片封装的方法，可以为原有的图片关联创建用户的信息
     * @param picture
     * @param request
     * @return
     */
    PictureVO getPictureVO(Picture picture, HttpServletRequest request);

    /**
     * 分页获取图片封装
     * @param picturePage
     * @param request
     * @return
     */
    Page<PictureVO> getPictureVOPage(Page<Picture> picturePage, HttpServletRequest request);

    /**
     * 编写图片数据校验方法，用于更新和修改图片时进行判断
     * @param picture
     */
    void validPicture(Picture picture);

    /**
     * 管理员图片审核
     * @param pictureReviewRequest
     * @param loginUser
     */
    void doPictureReview(PictureReviewRequest pictureReviewRequest, User loginUser);

    /**
     * 设置审核状态，管理员上传的东西自动过审；用户上传的图片自动设置为待审核
     * @param picture
     * @param loginUser
     */
    void fillReviewParams(Picture picture, User loginUser);

    /**
     * 批量抓取和创建图片
     * @param pictureUploadByBatchRequest
     * @param loginUser
     * @return  成功创建的图片数目
     */
    Integer uploadPictureByBatch(PictureUploadByBatchRequest pictureUploadByBatchRequest, User loginUser);

    /**
     * 图片清理方法
     * 注意，删除图片时，需要先判断该图片地址是否还存在于其他记录里，确认没有才能删除。
     * 比如秒传的场景，就有可能多个图片地址指向同一个文件。
     * 此外，还要注意删除对象存储中的文件时传入的是 key（不包含域名的相对路径），而数据库中取到的图片地址是包含域名的
     * 所以删除前要移除域名，从而得到 key。
     * @param oldPicture
     */
    void clearPictureFile(Picture oldPicture);

    /**
     * 如果要删除的图片有空间 id，表示是用户上传到私有空间中的图片，那么登录用户必须是空间的管理员（也就是创建者）
     * 系统管理员也不能随意删除私有空间的图片
     * 删除图片和编辑图片的权限控制是一样的，有删除权限就有编辑权限，这样就可以将权限校验的逻辑封装为一个方法使用
     * @param loginUser
     * @param picture
     */
    void checkPictureAuth(User loginUser, Picture picture);

    /**
     * 原本删除图片 deletePicture 逻辑很简单，直接写到了 Controller 中，现在有了更多的逻辑
     * 就封装到 Service 层中，并同步修改 Controller 来调用 Service
     * @param pictureId
     * @param loginUser
     */
    void deletePicture(long pictureId, User loginUser);

    /**
     * 和删除图片的校验逻辑一样，判断需要编辑的图片是否有 空间id，表示是用户上传到私有空间中的图片
     * 那么登录的用户就必须是空间管理员->即创建者，系统管理员就不可以随意编辑私有空间中的图片
     * 将 editPicture 抽象到 Service 层，然后同步改写 Controller 层的方法
     * @param pictureEditRequest
     * @param loginUser
     */
    void editPicture(PictureEditRequest pictureEditRequest, User loginUser);

    /**
     * 按颜色查询图片的方法，不和其他搜索条件放在一起
     * @param spaceId
     * @param picColor
     * @param loginUser
     * @return
     */
    List<PictureVO> searchPictureByColor(Long spaceId, String picColor, User loginUser);

    /**
     * 批量修改图片服务，依次完成参数校验、空间权限校验、图片查询、批量更新操作
     * @param pictureEditByBatchRequest
     * @param loginUser
     */
    void editPictureByBatch(PictureEditByBatchRequest  pictureEditByBatchRequest, User loginUser);

    /**
     * 创建扩图任务方法，从数据库中获取图片信息和 url 地址，构造请求参数后调用 api 创建扩图任务
     * 如果图片有空间 id，则需要校验权限，直接复用以前的权限校验方法
     * @param     createPictureOutPaintingTaskRequest createPictureOutPaintingTask(CreatePictureOutPaintingTaskRequest createPictureOutPaintingTaskRequest, User loginUser);
     * @param loginUser
     * @return
     */
    CreateOutPaintingTaskResponse createPictureOutPaintingTask(CreatePictureOutPaintingTaskRequest createPictureOutPaintingTaskRequest, User loginUser);
}
